<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>运行时配置</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="phar.installation.html">« 安装</a></li>
      <li style="float: right;"><a href="phar.resources.html">资源类型 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="phar.setup.html">安装/配置</a></li>
    <li>运行时配置</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="phar.configuration" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>文件系统和 stream 配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="phar.configuration.html#ini.phar.readonly" class="link">phar.readonly</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="phar.configuration.html#ini.phar.require-hash" class="link">phar.require_hash</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="phar.configuration.html#ini.phar.cache-list" class="link">phar.cache_list</a></td>
      <td>&quot;&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td class="empty">&nbsp;</td>
     </tr>

    </tbody>
   
  </table>

 </p>

 <p class="para">这是配置指令的简短说明。</p>

 <p class="para">
  <dl>
   
    <dt id="ini.phar.readonly">
     <code class="parameter">phar.readonly</code>
     <span class="type">bool</span>
    </dt>

    <dd>

     <p class="para">
      在使用 <code class="literal">phar</code> 流或 <span class="classname"><a href="class.phar.html" class="classname">Phar</a></span> 对象的写入操作时，
      本选项可以禁止创建、修改 Phar 归档。
      在生产环境中推荐始终启用本设置，否则伴随其他常见安全漏洞，
      phar 扩展支持写入时也能创建基于 PHP 的病毒。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       出于安全考虑，只能在 php.ini 中取消此设置。
       若在 php.ini 中禁用 <code class="literal">phar.readonly</code>，可以在代码中启用 <code class="literal">phar.readonly</code> 或其后禁用它。
       若在 php.ini 中启用 <code class="literal">phar.readonly</code>，在代码中只能 &quot;重复启用&quot; INI 变量，不能禁用。
      </p>
     </p></blockquote>
    </dd>

   

   
    <dt id="ini.phar.require-hash">
     <code class="parameter">phar.require_hash</code>
     <span class="type">bool</span>
    </dt>

    <dd>

     <p class="para">
      此选项要求调用的所有 Phar 归档必须包含签名（目前支持的签名类型有 MD5、SHA1、SHA256、SHA512、OpenSSL），
      而且会拒绝处理不含签名的 Phar 归档。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       只能在 php.ini 中取消此设置。
       若在 php.ini 中禁用 <code class="literal">phar.require_hash</code>，可以在代码中启用 <code class="literal">phar.require_hash</code> 或其后禁用它。
       若在 php.ini 中启用 <code class="literal">phar.require_hash</code>，在代码中可以 &quot;重复启用&quot; INI 变量，但不能禁用它。
      </p>
      <p class="para">
       此选项不影响 <span class="classname"><a href="class.phardata.html" class="classname">PharData</a></span> 类读取普通 tar 文件。
      </p>
     </p></blockquote>
     <div class="caution"><strong class="caution">警告</strong>
      <p class="simpara">
       <code class="literal">phar.require_hash</code> 本身不提供任何安全保障，它只能阻止运行因意外而损坏的 Phar 归档，
       因为任何人都可以篡改 Phar 归档后轻松修改成对应的签名。
      </p>
     </div>
    </dd>

   

   
    <dt id="ini.phar.cache-list">
     <code class="parameter">phar.cache_list</code>
     <span class="type">string</span>
    </dt>

    <dd>

     <p class="para">
      允许 web 服务启动时预先解析映射 phar 归档，提供性能上的优化，
      使得从 phar 归档中运行文件的速度几乎接近从传统的基于磁盘安装运行这些文件的速度。
      <div class="example" id="example-713">
       <p><strong>示例 #1 phar.cache_list 用法示例</strong></p>
       <div class="example-contents">
<div class="cdata"><pre>
在 php.ini 中（windows）：
phar.cache_list =C:\path\to\phar1.phar;C:\path\to\phar2.phar
在 php.ini 中（unix）：
phar.cache_list =/path/to/phar1.phar:/path/to/phar2.phar
</pre></div>
       </div>

      </div>
     </p>
    </dd>

   
  </dl>

 </p>
</div></div></div></body></html>